利用Github Actions自动化部署 Hexo博客
发表于:2023-07-11 |

Github Action自动化部署是什么

简单说,就是把hexo博客编译前的源代码上传到github代码仓库,Action在代码发生变动的时候,自动通过安装一系列nodejs环境和相关依赖,编译生成html页面到github pages仓库。

再简单点说,就是把本地生成博客的工作,全部交给Action执行。

好处就是随时随地都能修改或增加博文

预览

https://1422756921.github.io/

前言

之前搭建的hexo到现在都没怎么看过,今天准备清理电脑磁盘的时候就发现了hexo源码,现在有空打算弄个自动化,免得以后不小心删了。使用 GitHub Actions 实现将 Hexo 博客自动编译并发布到 GitHub Pages 上。顺便记录一下

正文

做自动化部署前,先搭建好hexo并部署到GitHub pages上(可以参考这篇https://blog.aerr.cn/825.html

先建一个私有仓库(myhexo),这个仓库存放的是编译前的文件,也就是你电脑本地的文件,这个仓库是拿来做自动化的

也就是一共两个仓库

  • 一个公有仓库存编译好的hexo(pages仓库,用户名例如是1422756921.github.io
  • 一个私有仓库存本地电脑编译前的文件(自动化仓库,用户名是myhexo

上传编译前的代码

创建完私有仓库后,在本地博客文件中复制几个文件到另外一个文件夹,其中包括.githubscaffoldssourcethemes_config.ymlpackage.jsonpackage-lock.json

还有一个很重要的一步:打开模板文件,把.git文件删除

然后回到根目录右键打开git bash

在git bash里依次输入以下命令

1
2
3
4
5
6
7
8
9
git init  #把这个目录变成Git可以管理的仓库
git add . #添加当前目录文件到缓存区(别漏命令后面的点)
git commit -m "first commit" #提交缓存区内容到本地库,并备注first commit

#下面两条命令二选一,就行了
git remote add origin https://github.com/用户名/自动化仓库名.git #利用https关联远程仓库
git remote add origin git@github.com:用户名/自动化仓库名.git #利用ssh关联远程仓库

git push -u origin master #把本地库的所有内容推送到远程库上

同样SSHHTTPS均可。SSH在绑定过ssh key的设备上无需再输入密码,HTTPS则需要输入密码,但是SSH偶尔会遇到端口占用的情况。

获取 Github token

打开https://github.com/settings/tokens
点击 Generate new token 新建个 token

note随便填,Expiration选择No expiration,勾选repo和workflow,其他没什么了,然后点生成就好了

把token复制下来

打开自动化仓库的Settings<span> </span>-> Secrets and variables -> Actions -> New repository secret

一共有三个变量名GITHUBTOKENGITHUBUSERNAMEGITHUBEMAIL,逐一添加

变量声明
变量名 常量释义
GITHUBMAIL Github 用户邮箱地址
GITHUBTOKEN Github token
GITHUBUSERNAME Github 用户名

添加workflows

接下来点击Actions<span> </span>-> set up a workflow yourself

复制以下代码到里面

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
name: 自动部署

on:
push:
branches:
- main

release:
types:
- published

jobs:
deploy:
runs-on: ubuntu-latest
steps:
- name: 检查分支
uses: actions/checkout@v2
with:
ref: main

- name: 安装 Node
uses: actions/setup-node@v1
with:
node-version: "16.x"

- name: 安装 Hexo
run: |
export TZ='Asia/Shanghai'
npm install hexo-cli -g

- name: 缓存 Hexo
uses: actions/cache@v1
id: cache
with:
path: node_modules
key: ${{runner.OS}}-${{hashFiles('**/package-lock.json')}}

- name: 安装依赖
if: steps.cache.outputs.cache-hit != 'true'
run: |
npm install --save

- name: 生成静态文件
run: |
hexo clean
hexo generate

- name: 部署 #此处master:master 指从本地的master分支提交到远程仓库的master分支(不是博客的分支写master即可),若远程仓库没有对应分支则新建一个。如有其他需要,可以根据自己的需求更改。
run: |
cd ./public
git init
git config --global user.name '${{ secrets.GITHUBUSERNAME }}'
git config --global user.email '${{ secrets.GITHUBEMAIL }}'
git add .
git commit -m "${{ github.event.head_commit.message }} $(date +"%Z %Y-%m-%d %A %H:%M:%S") Updated By Github Actions"
git push --force --quiet "https://${{ secrets.GITHUBUSERNAME }}:${{ secrets.GITHUBTOKEN }}@github.com/${{ secrets.GITHUBUSERNAME }}/${{ secrets.GITHUBUSERNAME }}.github.io.git" master:master # GitHub配置
git push --force --quiet "https://${{ secrets.TOKENUSER }}:${{ secrets.CODINGTOKEN }}@e.coding.net/${{ secrets.CODINGUSERNAME }}/${{ secrets.CODINGBLOGREPO }}.git" master:master # coding配置
git push --force --quiet "https://${{ secrets.GITEEUSERNAME }}:${{ secrets.GITEETOKEN }}@gitee.com/${{ secrets.GITEEUSERNAME }}/${{ secrets.GITEEUSERNAME }}.git" master:master # gitee配置

==上方代码配置包含 gitee 和 coding,请自行删减==

粘贴上去后点击Commit changes…

就大功告成了,可以点击Actions查看运行进程了

最后,需要到GitHub pages那个仓库里面把默认页改成master就好了

上一篇:
一个hexo博客后台–Qexo
下一篇:
Hexo博客搭建